Les API offrent de formidables opportunités de mutualisation dans différents produits. Aujourd’hui, zoom sur l’API recherche-entreprises, initialement développée par l’équipe du Code du travail numérique et désormais également utilisée par trois autres équipes de la sphère travail.

L’API recherche-entreprises permet de retrouver les données publiques détenues par l’administration sur une entreprise ou une association (notamment les données contenues dans un extrait KBIS), à travers la base SIREN de l’Insee.

Pour comprendre comment elle fonctionne, l’équipe a mis à disposition un démonstrateur en ligne. En pratique, je peux trouver une entreprise par nom, numéro de SIREN ou numéro de SIRET. J’obtiens également un lien pour consulter la fiche de l’entreprise sur le site annuaire-entreprises.data.gouv.fr.

Mais alors, quelle est la différence entre cette API et Annuaire-entreprises ? Les deux outils poursuivent le même objectif : retrouver les informations principales sur une entreprise. Mais le site Annuaire-entreprises est fait pour que des humains cherchent des informations. L’API recherche-entreprises est, comme son nom l’indique, une API, et elle permet à un ordinateur de récupérer automatiquement ces informations.

En pratique, les outils sont donc complémentaires.

L’équipe du Code du travail numérique a développé cette API pour l’utiliser dans plusieurs outils, par exemple celui de recherche de convention collective. En un clic, un employeur ou un salarié peut savoir quelle est la convention collective de son entreprise en indiquant simplement le nom de son entreprise, ou son numéro de SIRET.

Le moteur de recherche a été amélioré au fil du temps : par exemple, les personnes travaillant pour des marques ayant plusieurs magasins (comme les marques de vêtements) avaient des difficultés à trouver la convention collective correspondant à leur magasin. C’est désormais facilité, en faisant une recherche par nom d’entreprise et code postal.

L’équipe du Code du travail numérique travaille en open source. Elle a donc rendu l’API publique sur GitHub (une plateforme de partage de codes sources pour développeurs et développeuses), ce qui permet son utilisation par d’autres projets.

En pratique, beaucoup de projets ont besoin de rechercher automatiquement des informations dans la base SIREN de l’Insee. Ainsi, trois autres équipes l’utilisent maintenant dans leurs produits : EgaPro (l’outil de calcul et de déclaration de l’index égalité professionnelle Femmes-Hommes des entreprises), Fiche Commune Entreprise (qui permet aux agents publics de mutualiser leurs connaissances sur les entreprises), et Mon-entreprise (l’outil de l’URSSAF pour aider les entrepreneurs à développer leur activité).

Grâce aux développements réalisés par l’équipe du Code du travail numérique, chaque équipe a pu ainsi économiser plusieurs heures de développement, et peut également contribuer à améliorer l’API au fur et à mesure.

L’équipe est actuellement en lien avec la DARES pour compléter les données avec les entreprises manquantes.

Vous utilisez aussi l’API recherche-entreprises ? Vous dirigez un projet et cette API pourrait vous intéresser ? N’hésitez pas à nous le faire savoir (ressourcerie@numericite.eu) !

Côté tech : découvrez l’API et accédez au code source sur la fiche ressource associée.